home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 January: Mac OS SDK / Dev.CD Jan 96 SDK / Dev.CD Jan 96 SDK1.toast / Development Kits (Disc 1) / AOCE / Development Tools / Sample Code / Catalog Service Access Module / DTS Sample CSAM / DTS Sample CSAM ReadMe < prev    next >
Encoding:
Text File  |  1993-11-05  |  2.7 KB  |  53 lines  |  [ttro/ttxt]
  1. AOCE Software Developers Kit 1.0                                                                                                            November 5, 1993
  2. -----------------------------------------------------------------------------
  3. DTS Sample CSAM
  4. 5/27/93, Version xx
  5.  
  6. DTS CSAM is a sample Catalog Service Access Module that "connects" a catalog to a personal catalog. It compiles and builds under both MPW and Think C.
  7.  
  8. The DTS Sample CSAM that is built from sources in this folder and its subfolders. It also summarizes the AOCE documentation from the point of view of a programmer implementing a DSAM and its associated directory template. One goal of this project is to provide a set of sources that can be compiled under either MPW or Think C 6.0.
  9.  
  10. ••• Building the CSAM
  11.  
  12. The MPW Makefile builds the CSAM from its components. The procedure
  13. first builds the template resource, then the driver, then uses Rez to
  14. combine these with the various resources needed by the Catalog Manager.
  15.  
  16. Under Think C (6.0.1 or later), you must build the CSAM manually by
  17. first compiling the template resource (DTSSampleTemplate.π project),
  18. then compiing the driver (DTSSampleDriver.π). This latter step includes
  19. the template resource and the other string (etc) resources.
  20.  
  21. The two CSAM's are (or at least should be) functionally identical. There
  22. are one or two minor differences in the resources because of limitations
  23. in the current version of Think Rez. You should not change the "Project
  24. Type" parameters unless you are very certain of what you are doing.
  25.  
  26. ••• Audit logging.
  27.  
  28. The CSAM was developed as a debugging/exploration tool, rather than
  29. as a functional product. It uses an Audit logging subroutine library to
  30. record its actions (and especially any errors that it detects). In order
  31. to read and interpret the audit log, you will need the Display Audit
  32. application and/or the Audit MacsBug dcmd. These are provided in a
  33. separate package found in the "Unsupported Tools" folder.
  34.  
  35. The Audit package is a general-purpose event logger, suitable for
  36. drivers, code resources, and similar asynchronous code modules.
  37. It is not specific to AOCE or CSAM's.
  38.  
  39. Compilation Environment:
  40.     MPW 3.3
  41.     or THINK C V 6.0.1
  42.  
  43.             Two Think C (6.0) projects are needed to build the code resources. See
  44.             the comments in !ReadMeForThink.c for details.
  45.  
  46. Author: Martin Minow-DTS, AppleLink: DEVSUPPORT
  47.  
  48. Questions/Comments: As with the other AOCE samples, technical questions should be addressed to DEVSUPPORT.
  49.  
  50. -----------------------------------------------------------------------------
  51. Copyright © 1992-93, Apple Computer Inc. All Rights Reserved.
  52.  
  53. This tool is provided as part of the AOCE SDK.  Use of this tool for any purpose other than the development of AOCE-based Macintosh® products is a violation of the license agreement covering this SDK.